package com.zenithmind.library.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.zenithmind.library.pojo.domain.Author;
import com.zenithmind.library.pojo.query.AuthorQuery;
import com.zenithmind.library.pojo.vo.AuthorVO;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 作者Mapper接口
 * 
 * @author ZenithMind
 * @since 2024-06-14
 */
@Mapper
public interface AuthorMapper extends BaseMapper<Author> {

    /**
     * 分页查询作者
     * 
     * @param page 分页参数
     * @param query 查询条件
     * @return 分页结果
     */
    IPage<AuthorVO> selectAuthorPage(Page<AuthorVO> page, @Param("query") AuthorQuery query);

    /**
     * 根据姓名查询作者
     * 
     * @param name 作者姓名
     * @return 作者列表
     */
    List<AuthorVO> selectByName(@Param("name") String name);

    /**
     * 根据图书ID查询作者
     * 
     * @param bookId 图书ID
     * @return 作者列表
     */
    List<AuthorVO> selectByBookId(@Param("bookId") String bookId);

    /**
     * 搜索作者
     * 
     * @param keyword 关键词
     * @param limit 限制数量
     * @return 作者列表
     */
    List<AuthorVO> searchAuthors(@Param("keyword") String keyword, @Param("limit") Integer limit);

    /**
     * 更新作品数量
     * 
     * @param authorId 作者ID
     * @param bookCount 作品数量
     * @return 更新行数
     */
    int updateBookCount(@Param("authorId") String authorId, @Param("bookCount") Integer bookCount);

    /**
     * 增加作品数量
     * 
     * @param authorId 作者ID
     * @return 更新行数
     */
    int incrementBookCount(@Param("authorId") String authorId);

    /**
     * 减少作品数量
     * 
     * @param authorId 作者ID
     * @return 更新行数
     */
    int decrementBookCount(@Param("authorId") String authorId);

    /**
     * 更新总借阅次数
     * 
     * @param authorId 作者ID
     * @param totalBorrowCount 总借阅次数
     * @return 更新行数
     */
    int updateTotalBorrowCount(@Param("authorId") String authorId, @Param("totalBorrowCount") Long totalBorrowCount);

    /**
     * 增加总借阅次数
     * 
     * @param authorId 作者ID
     * @return 更新行数
     */
    int incrementTotalBorrowCount(@Param("authorId") String authorId);

    /**
     * 批量更新作者状态
     * 
     * @param ids 作者ID列表
     * @param status 状态
     * @return 更新行数
     */
    int batchUpdateStatus(@Param("ids") List<String> ids, @Param("status") Integer status);

    /**
     * 查询热门作者
     * 
     * @param limit 限制数量
     * @return 热门作者列表
     */
    List<AuthorVO> selectHotAuthors(@Param("limit") Integer limit);

    /**
     * 查询高产作者
     * 
     * @param limit 限制数量
     * @return 高产作者列表
     */
    List<AuthorVO> selectProductiveAuthors(@Param("limit") Integer limit);

    /**
     * 统计作者数量
     * 
     * @param query 查询条件
     * @return 作者数量
     */
    Long countAuthors(@Param("query") AuthorQuery query);

    /**
     * 检查作者姓名是否存在
     * 
     * @param name 作者姓名
     * @param excludeId 排除的ID
     * @return 是否存在
     */
    boolean existsByName(@Param("name") String name, @Param("excludeId") String excludeId);
}
